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• LocalService { 

char * serviceName; 
int receiveWhenRunning; 
int receiveWhenNotRunning; 
int running; 

fl(r. int maxNumOfMessagesToStore; 

char * exp_fldl; 
char * exp_fld2; 
char * exp_fld3; 
char * exp_fld4; 
char * exp_fld5; 
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RemoteService { 
char * serviceName; 
char * userName; 

}; 
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KMessage { 

char * serviceName; 
char * date; 
char * recipient; 
char * sender; 
char * messageBody; 

}; 
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Name 


sendMessage 


Arguments 


char * to, char * serviceName, char * data 


Return Values 


int err 


Description 


This function provides sending capabilities 
so that messages or any kind of 
unformatted text can be sent between 
Bluetooth devices. Reception of the text is 
guaranteed, because even when the devices 
are not within range, the text is stored and 
communicated via an Internet connection. 
If a user is logged in to more than one 
device simultaneously, the message/text 
will be sent to both devices at the same 
time. 




Name 


getMessages 


Arguments 


struct KMessage * message 


Return Values 


int err 


Description 


The getMessages function retrieves all 
messages or any other unformatted text 
sent from another Bluetooth device. It 
returns the data in the KMessage data 
structure. If a user is logged in to more 
than one device simultaneously, the 
message/text will be received from both 
devices at the same time. 



Name 


getMessage 


Arguments 


struct KMessage * message 


Return Values 


int err 


Description 


The getMessage function retrieves just one 
message or any other unformatted text sent 
from another Bluetooth device. It returns 
the data in the KMessage data structure. If 
a user is logged in to more than one device 
simultaneously, the message/text will be 
received from both devices at the same 
time. 
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Name 


getSurroundingServices 




Arguments 


struct RemoteService areaServices fl 




HD 


Return Values 


int err 






Description 


This function returns an array of mappings 
of users and services available on that 
user's device. This information was 
previously stored in a database termed the 
registry, which is a list of devices within 
range of a Bluetooth device. 
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Name 


AddService 




Arguments 


char * serviceName 




Return Values 


int err 






Description 


This function adds a service entry to the 
registry. 
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Name 


RemoveService 




Arguments 


char * serviceName 




Return Values 


int err 






Description 


This function removes a service entry from 
the registry. 
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Name 


changePMTdata 




Arguments 


«waiting to hear about PMT API» 




Return Values 


int err 






Description 


A function that allows users to update their 
personal PMT data and preferences using 
their particular devices. If the device is not 
within Bluetooth range of an Internet 
connection, it will store these update 
preferences, and make changes within the 
permanent PMT upon coming into contact 
with an Internet connection. 
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Name 


GetPMTdata 




Arguments 


char * user 




Return Values 


int en- 








Allows a service to get the PMT data of a 
particular user from the PMT database. If 
the service cannot reach the PMT database, 
the information comes from the local 
storage on the device of the user. Only 
information that is designated as shared or 
public data will be retrieved. 
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Name 


ChangePMTpermissions 




vx 


Arguments 


«waiting to hear about PMT API» 




Return Values 


int err 






Description 


This function allows a user to change his 
PMT permissions from his device. 
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( 100 The particular service application passes a message with an identification of the 
intended recipient to the applications manager 

f 102 The applications manager passes the message and recipient's identification to the 
communications manager and requests that the message be transmitted in a secure and 
guaranteed manner 

1 104 The communications manager passes the message and security information to the 
security module ^ 

1 1 06 The security module executes the cryptographic algorithm on the message and 
returns the encrypted message to the communications manager 

f 108 The communications manager passes the encrypted message to the confirmation 
manager and specifies the channel of communication 

1110 The confirmation manager generates a message identification number and 
attaches it to the message header j 

f 1 12 The confirmation manager adds the encrypted message to its queue of non- 
confirmed messages 

/ 1 14 The confirmation manager passes the encrypted message and the specified 
channel to the transfer module 

(116 The transfer module sends the encrypted message over the specified 
communication channel j 

f 1 1 8 The transfer module in the recipient device receives the encrypted message and 
passes it to the recipient device's confirmation manager 

1 

1 120 The confirmation manager in the recipient device passes the message to the 
communications manager < 

f V 

\ 1 22 The confirmation manager in 1 130 The communications manager 
the recipient device adds the message in the recipient device removes the header 
identification number to its list of 
received messages and generates 
a confirmation message that is passed 
to the transfer module in the recipient 
device 

1 * 

TO/124 TO/132 
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1 1 24 The transfer module sends the 
confirmation message over the same 
communication channel over which the 
original message arrived 

1 1 26 The transfer module in the sending 
device receives the confirmation message 
and passes it to the confirmation manager 

\ 1 28 The confirmation manager removes 
the original message from its queue of 
messages that are awaiting confirmation 



* 1 32 The communication manager 
passes the encrypted, digitally signed 
message to the security module in 
the recipient device 

(134 The security module 
responds with the sender's identity 



l 



1 1 3 6 The communications 
manager in the recipient device adds 
the decrypted message to its message 
queue 



(138 The communications 
manager notifies the user and service 
application according to the settings 
in the registry of the recipient device 

I 

\\40 The service application requests the message from 
the communications manager through the applications 
manager in the recipient device 

{ 142 The communications manager passes the next 
message marked for the intended application from the 
message queue to the service application 

\ 144 The communications manager deletes the message 
from its message queue 
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